home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE3 / PD / VICE / doc / vice_7 < prev    next >
Text File  |  2002-09-01  |  35KB  |  1,486 lines
  1. <HTML>
  2. <HEAD>
  3. <!-- This HTML file has been created by texi2html 1.52
  4.      from ../vice.texi on 31 August 2002 -->
  5.  
  6. <TITLE>VICE Manual - 7  Machine-specific features</TITLE>
  7. </HEAD>
  8. <BODY>
  9. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_6.html">previous</A>, <A HREF="vice_8.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  10. <P><HR><P>
  11.  
  12.  
  13. <H1><A NAME="SEC74" HREF="vice_toc.html#TOC74">7  Machine-specific features</A></H1>
  14.  
  15.  
  16.  
  17. <H2><A NAME="SEC75" HREF="vice_toc.html#TOC75">7.1  C64/128-specific commands and settings</A></H2>
  18.  
  19. <P>
  20. This section lists the settings and commands that are C64/128 specific
  21. and thus are not present in the other emulators.
  22.  
  23. </P>
  24.  
  25.  
  26.  
  27. <H3><A NAME="SEC76" HREF="vice_toc.html#TOC76">7.1.1  Using cartridge images</A></H3>
  28.  
  29. <P>
  30. <EM>Cartridge images</EM> are like disk images, but mirror the contents of
  31. cartridge ROM images instead of disk images.
  32.  
  33. </P>
  34. <P>
  35. X64 and X128 allow you to attach the following kinds of cartridges:
  36.  
  37. </P>
  38.  
  39. <UL>
  40. <LI>
  41.  
  42. <TT>`.crt'</TT> images, as used by the CCS64 emulator by Per Håkan Sundell;
  43. <LI>
  44.  
  45. generic raw dumps of 8K and 16K images;
  46. <LI>
  47.  
  48. Action Replay images.
  49. <LI>
  50.  
  51. Atomic Power images.
  52. <LI>
  53.  
  54. Epyx fastload images.
  55. <LI>
  56.  
  57. The Commodore IEEE488 interface cartridge
  58. (<CODE>http://www.funet.fi/pub/cbm/schematics/cartridges/c64/ieee-488/eprom.bin</CODE>)
  59. <LI>
  60.  
  61. Retro Replay images.
  62. <LI>
  63.  
  64. IDE64 interface cartridge.
  65. (<CODE>http://www.volny.cz/dundera/</CODE>)
  66. <LI>
  67.  
  68. Super Snapshot 4 images.
  69. <LI>
  70.  
  71. Super Snapshot 5 images.
  72. <LI>
  73.  
  74. Expert Cartridge images.
  75. </UL>
  76.  
  77. <P>
  78. Each of these kinds has a specific command in the "Attach a cartridge
  79. image" submenu.  When you have successfully attached a cartridge image,
  80. you should then reset the machine to make sure the cartridge initializes
  81. itself.  Of course, it is also possible to detach a currently attached
  82. cartridge image ("Detach cartridge image").
  83.  
  84. </P>
  85. <P>
  86. If you are using a freezer cart like an Action Replay cartridge, you can
  87. emulate the cartridge's freeze button with the "Cartridge freeze"
  88. command.
  89.  
  90. </P>
  91. <P>
  92. Attaching the IEEE488 cartridge automatically enables the IEEE488
  93. interface emulation on the <CODE>$DF**</CODE> I/O ports.
  94.  
  95. </P>
  96. <P>
  97. Attaching the IDE64 cartridge automatically enables the IDE64
  98. interface emulation on the <CODE>$DE**</CODE> I/O ports.
  99.  
  100. </P>
  101.  
  102.  
  103. <H3><A NAME="SEC77" HREF="vice_toc.html#TOC77">7.1.2  VIC-II settings</A></H3>
  104.  
  105. <P>
  106. These settings control the emulation of the VIC-II (MOS6569) video chip
  107. used in both the C64 and the C128.
  108.  
  109. </P>
  110.  
  111. <UL>
  112.  
  113. <LI>
  114.  
  115. <A NAME="IDX182"></A>
  116.  
  117. "Sprite-sprite collisions" and "Sprite-background collisions", if
  118. enabled, cause the hardware detection of sprite-to-sprite and
  119. sprite-to-background collisions of the VIC-II to be emulated.  This
  120. feature is used by many games, and disabling either of the two detection
  121. systems can sometimes make you invincible (although there is also a
  122. chance that also enemies become invincible then).
  123.  
  124. <A NAME="IDX183"></A>
  125. <LI>
  126.  
  127. "Color set" can be used to dynamically change the palette file
  128. being used by choosing one of the available predefined color sets:
  129.  
  130.  
  131. <UL>
  132. <LI>
  133.  
  134. <TT>`default.vpl'</TT> ("default"), the default VICE palette;
  135. <LI>
  136.  
  137. <TT>`c64s.vpl'</TT> ("C64S"), palette taken from the shareware C64S
  138. emulator by Miha Peternel.
  139. <LI>
  140.  
  141. <TT>`ccs64.vpl'</TT> ("CCS64"), palette taken from the shareware CCS64
  142. emulator by Per Håkan Sundell.
  143. <LI>
  144.  
  145. <TT>`frodo.vpl'</TT> ("Frodo"), palette taken from the free Frodo emulator
  146. by Christian Bauer
  147. (<A HREF="http://www.uni-mainz.de/~bauec002/FRMain.html">http://www.uni-mainz.de/~bauec002/FRMain.html</A>).
  148. <LI>
  149.  
  150. <TT>`pc64.vpl'</TT> ("PC64"), palette taken from the free PC64 emulator by
  151. Wolfgang Lorenz.
  152. <LI>
  153.  
  154. <TT>`godot.vpl'</TT> ("GoDot"), palette as suggested by the authors of the
  155. C64 graphics package GoDot
  156. (<A HREF="http://users.aol.com/howtogodot/welcome.htm">http://users.aol.com/howtogodot/welcome.htm</A>).
  157. </UL>
  158.  
  159. </UL>
  160.  
  161.  
  162.  
  163. <H4><A NAME="SEC78" HREF="vice_toc.html#TOC78">7.1.2.1  VIC-II resources</A></H4>
  164.  
  165. <DL COMPACT>
  166.  
  167. <DT><CODE>CheckSsColl</CODE>
  168. <DD>
  169. <A NAME="IDX184"></A>
  170.  
  171. Boolean specifying whether the sprite-sprite hardware collision
  172. detection must be emulated.
  173.  
  174. <A NAME="IDX185"></A>
  175. <DT><CODE>CheckSbColl</CODE>
  176. <DD>
  177. Boolean specifying whether the sprite-background hardware collision
  178. detection must be emulated.
  179.  
  180. </DL>
  181.  
  182.  
  183.  
  184. <H4><A NAME="SEC79" HREF="vice_toc.html#TOC79">7.1.2.2  VIC-II command-line options</A></H4>
  185.  
  186. <DL COMPACT>
  187.  
  188. <DT><CODE>-checkss</CODE>
  189. <DD>
  190. <A NAME="IDX186"></A>
  191.  
  192. <DT><CODE>+checkss</CODE>
  193. <DD>
  194. Enable (<CODE>CheckSsColl=1</CODE>) and disable (<CODE>CheckSsColl=0</CODE>)
  195. emulation of hardware sprite-sprite collision detection, respectively.
  196. <A NAME="IDX187"></A>
  197.  
  198. <A NAME="IDX188"></A>
  199. <DT><CODE>-checksb</CODE>
  200. <DD>
  201. <DT><CODE>+checksb</CODE>
  202. <DD>
  203. Enable (<CODE>CheckSbColl=1</CODE>) and disable (<CODE>CheckSbColl=0</CODE>)
  204. emulation of hardware sprite-background collision detection,
  205. respectively.
  206.  
  207. </DL>
  208.  
  209.  
  210.  
  211. <H3><A NAME="SEC80" HREF="vice_toc.html#TOC80">7.1.3  SID settings</A></H3>
  212.  
  213. <P>
  214. These settings control the emulation of the SID (MOS6581 or MOS8580)
  215. audio chip.
  216.  
  217. </P>
  218.  
  219. <UL>
  220.  
  221. <LI>
  222.  
  223. <A NAME="IDX189"></A>
  224.  
  225. "Second SID" maps a second SID chip into the address space for stereo
  226. sound. This emulates e.g. the "SID Symphony Stereo Cartridge" from
  227. Dr. Evil Laboratories. The second SID can be used with software such as
  228. "Stereo SID Player" by Mark Dickenson or "The Enhanced Sidplayer" by
  229. Craig Chamberlain.
  230.  
  231. <A NAME="IDX190"></A>
  232. <LI>
  233.  
  234. "Second SID base address" sets the start address for the second SID
  235. chip. Software normally uses $DE00 or $DF00, since $DE00-$DEFF and
  236. $DF00-$DFFF can be mapped through the cartridge port of the C64. The
  237. default start address is $DE00.
  238.  
  239. <A NAME="IDX191"></A>
  240. <LI>
  241.  
  242. "Emulate filters" causes the built-in programmable filters of the SID
  243. chip to be emulated.  A lot of C64 music requires them to be emulated
  244. properly, but their emulation requires some additional processor power.
  245.  
  246. <A NAME="IDX192"></A>
  247. <LI>
  248.  
  249. "ChipModel" specifies the model of the SID chip being emulated: there
  250. are two slightly different generations of SID chips: MOS6581 ones and
  251. MOS8580 ones.
  252.  
  253. <A NAME="IDX193"></A>
  254. <LI>
  255.  
  256. "Use reSID emulation" specifies whether the more accurate (and
  257. resource hungry) reSID emulation is turned on or off.
  258.  
  259. <A NAME="IDX194"></A>
  260. <LI>
  261.  
  262. "reSID sampling method" selects the method for conversion of the SID
  263. output signal to a sampling rate appropriate for playback by standard
  264. digital sound equipment. Possible settings are:
  265.  
  266. <UL>
  267. <LI>
  268.  
  269. "Fast" simply clocks the SID chip at the output sampling frequency,
  270. picking the nearest sample. This yields acceptable sound quality, but
  271. sampling noise is noticeable in some cases, especially with SID combined
  272. waveforms. The sound emulation is still cycle exact.
  273. <LI>
  274.  
  275. "Interpolating" clocks the SID chip each cycle, and calculates each
  276. sample with linear interpolation. The sampling noise is now strongly
  277. attenuated by the SID external filter (as long as "Emulate filters" is
  278. selected), and the linear interpolation further improves the sound
  279. quality.
  280. <LI>
  281.  
  282. "Resampling" clocks the SID chip each cycle, and uses the
  283. theoretically correct method for sample generation. This delivers CD
  284. quality sound, but is extremely CPU intensive, and is thus most useful
  285. for non-interactive sound generation. Unless you have a very fast
  286. machine, that is.
  287. </UL>
  288.  
  289. <A NAME="IDX195"></A>
  290. <LI>"reSID resampling passband" specifies the percentage of the
  291.  
  292. total bandwidth allocated to the resampling filter passband. The work
  293. rate of the resampling filter is inversely proportional to the remaining
  294. transition band percentage. This implies that e.g. with the transition
  295. band starting at ~ 20kHz, it is faster to generate 48kHz than 44.1kHz
  296. samples. For CD quality sound generation at 44.1kHz the passband
  297. percentage should be set to 90 (i.e. the transition band starting at
  298. almost 20kHz).
  299.  
  300. </UL>
  301.  
  302.  
  303.  
  304. <H4><A NAME="SEC81" HREF="vice_toc.html#TOC81">7.1.3.1  SID resources</A></H4>
  305.  
  306. <DL COMPACT>
  307.  
  308. <DT><CODE>SidStereo</CODE>
  309. <DD>
  310. <A NAME="IDX196"></A>
  311.  
  312. Boolean selecting emulation of a second SID.
  313.  
  314. <A NAME="IDX197"></A>
  315. <DT><CODE>SidStereoAddressStart</CODE>
  316. <DD>
  317. Integer specifying the start address for the second SID.
  318.  
  319. <A NAME="IDX198"></A>
  320. <DT><CODE>SidFilters</CODE>
  321. <DD>
  322. Boolean specifying whether the built-in SID filters must be emulated.
  323.  
  324. <A NAME="IDX199"></A>
  325. <DT><CODE>SidModel</CODE>
  326. <DD>
  327. Integer specifying what model of the SID must be emulated (<CODE>0</CODE>:
  328. MOS6581, <CODE>1</CODE>: MOS8580).
  329.  
  330. <A NAME="IDX200"></A>
  331. <DT><CODE>SidUseResid</CODE>
  332. <DD>
  333. Boolean specifying whether the accurate reSID emulation is being used.
  334.  
  335. <A NAME="IDX201"></A>
  336. <DT><CODE>SidResidSampling</CODE>
  337. <DD>
  338. Integer specifying the sampling method (<CODE>0</CODE>: Fast, <CODE>1</CODE>:
  339. Interpolation, <CODE>2</CODE>: Resampling)
  340.  
  341. <A NAME="IDX202"></A>
  342. <DT><CODE>SidResidPassband</CODE>
  343. <DD>
  344. Integer specifying the resampling filter passband in percentage of the
  345. total bandwidth (<CODE>0 - 90</CODE>).
  346.  
  347. </DL>
  348.  
  349.  
  350.  
  351. <H4><A NAME="SEC82" HREF="vice_toc.html#TOC82">7.1.3.2  SID command-line options</A></H4>
  352.  
  353. <DL COMPACT>
  354.  
  355. <DT><CODE>-sidstereo</CODE>
  356. <DD>
  357. <A NAME="IDX203"></A>
  358.  
  359. Emulates a second SID chip for stereo sound (<CODE>SidStereo</CODE>).
  360.  
  361. <A NAME="IDX204"></A>
  362. <DT><CODE>-sidstereoaddress <CODE>ADDRESS</CODE></CODE>
  363. <DD>
  364. Specifies the start address for the second SID chip
  365. (<CODE>SidStereoAddressStart</CODE>).
  366.  
  367. <A NAME="IDX205"></A>
  368. <DT><CODE>-sidmodel MODEL</CODE>
  369. <DD>
  370. Specifies <CODE>MODEL</CODE> as the emulated model of the SID chip
  371. (<CODE>SidModel</CODE>).
  372.  
  373. <A NAME="IDX206"></A>
  374. <DT><CODE>-sidfilters</CODE>
  375. <DD>
  376. <DT><CODE>+sidfilters</CODE>
  377. <DD>
  378. Enable (<CODE>SidFilters=1</CODE>) or disable (<CODE>SidFilters=0</CODE>) emulation
  379. of the built-in SID filters.
  380.  
  381. <A NAME="IDX207"></A>
  382. <DT><CODE>-resid</CODE>
  383. <DD>
  384. <DT><CODE>+resid</CODE>
  385. <DD>
  386. Enable (<CODE>SidFilters=1</CODE>) or disable (<CODE>SidFilters=0</CODE>) usage of
  387. the reSID emulator.
  388.  
  389. <A NAME="IDX208"></A>
  390. <DT><CODE>-residsamp <CODE>METHOD</CODE></CODE>
  391. <DD>
  392. Specifies the sampling method; fast (<CODE>SidResidSampling=0</CODE>),
  393. interpolating (<CODE>SidResidSampling=1</CODE>), or resampling
  394. (<CODE>SidResidSampling=2</CODE>).
  395.  
  396. <A NAME="IDX209"></A>
  397. <DT><CODE>-residpass <CODE>PERCENTAGE</CODE></CODE>
  398. <DD>
  399. Specifies the resampling filter passband in percentage of the total
  400. bandwidth (<CODE>SidResidPassband=0-90</CODE>).
  401.  
  402. </DL>
  403.  
  404.  
  405.  
  406. <H3><A NAME="SEC83" HREF="vice_toc.html#TOC83">7.1.4  C64 I/O extension settings</A></H3>
  407.  
  408. <P>
  409. There are three I/O extensions available: they are located at the
  410. address range $DF00 ... $DFFF and each of them is controlled by a
  411. boolean resource.  Please use these extensions only when needed, as they
  412. might cause compatibility problems.
  413.  
  414. </P>
  415.  
  416. <UL>
  417.  
  418. <LI>
  419.  
  420. <A NAME="IDX210"></A>
  421.  
  422. The "emulator identification" extension allows programs to
  423. identify the kind of emulator they are running on, according to the
  424. emulation detection proposal by Wolfgang Lorenz.  This basically means
  425. that, when some locations in the $DFxx I/O space are read, the emulator
  426. returns some values which identify the emulator itself, its version and
  427. a copyright message.  If this extension is disabled, programs will have
  428. virtually no way to realize they are running on an emulator.
  429.  
  430. <A NAME="IDX211"></A>
  431. <LI>
  432.  
  433. The "512K RAM Expansion Unit" extension emulates a standard 512K
  434. Commodore RAM Expansion Unit; this can be used with GEOS and other
  435. programs that are designed to take advantage of it.  This currently
  436. works only in the C64 emulator.
  437.  
  438. <A NAME="IDX212"></A>
  439. <LI>FIXME
  440.  
  441. </UL>
  442.  
  443.  
  444.  
  445. <H4><A NAME="SEC84" HREF="vice_toc.html#TOC84">7.1.4.1  C64 I/O extension resources</A></H4>
  446.  
  447. <DL COMPACT>
  448.  
  449. <DT><CODE>IEEE488</CODE>
  450. <DD>
  451. <A NAME="IDX213"></A>
  452.  
  453. Boolean specifying whether the IEEE488 interface should
  454. be emulated or not.
  455.  
  456. <A NAME="IDX214"></A>
  457. <DT><CODE>REU</CODE>
  458. <DD>
  459. Boolean specifying whether the 512K RAM Expansion Unit should be
  460. emulated or not.
  461.  
  462. <A NAME="IDX215"></A>
  463. <DT><CODE>EmuID</CODE>
  464. <DD>
  465. Boolean specifying whether the emulation identification extension should
  466. be emulated or not.
  467.  
  468. </DL>
  469.  
  470.  
  471.  
  472. <H4><A NAME="SEC85" HREF="vice_toc.html#TOC85">7.1.4.2  C64 I/O extension command-line options</A></H4>
  473.  
  474. <DL COMPACT>
  475.  
  476. <DT><CODE>-ieee488</CODE>
  477. <DD>
  478. <A NAME="IDX216"></A>
  479.  
  480. <DT><CODE>+ieee488</CODE>
  481. <DD>
  482. Enable (<CODE>IEEE488=1</CODE>) or disable (<CODE>IEEE488=0</CODE>) emulation of the
  483. IEEE488 interface.
  484.  
  485. <A NAME="IDX217"></A>
  486. <DT><CODE>-reu</CODE>
  487. <DD>
  488. <DT><CODE>+reu</CODE>
  489. <DD>
  490. Enable (<CODE>REU=1</CODE>) or disable (<CODE>REU=0</CODE>) emulation of the
  491. 512K RAM Expansion Unit.
  492.  
  493. <A NAME="IDX218"></A>
  494. <DT><CODE>-emuid</CODE>
  495. <DD>
  496. <DT><CODE>+emuid</CODE>
  497. <DD>
  498. Enable (<CODE>EmuID=1</CODE>) or disable (<CODE>EmuID=0</CODE>) the emulation
  499. identification extension.
  500.  
  501. </DL>
  502.  
  503.  
  504.  
  505. <H3><A NAME="SEC86" HREF="vice_toc.html#TOC86">7.1.5  C64/128 system ROM settings</A></H3>
  506.  
  507. <P>
  508. These settings can be used to control what system ROMs are loaded in the
  509. C64/128 emulators at startup.  They cannot be changed from the menus.
  510.  
  511. </P>
  512.  
  513.  
  514.  
  515. <H4><A NAME="SEC87" HREF="vice_toc.html#TOC87">7.1.5.1  C64/128 system ROM resources</A></H4>
  516.  
  517. <DL COMPACT>
  518.  
  519. <DT><CODE>KernalName</CODE>
  520. <DD>
  521. <A NAME="IDX219"></A>
  522.  
  523. String specifying the name of the Kernal ROM (default <TT>`kernal'</TT>).
  524.  
  525. <A NAME="IDX220"></A>
  526. <DT><CODE>BasicName</CODE>
  527. <DD>
  528. String specifying the name of the Basic ROM (default <TT>`basic'</TT>).  In
  529. the C128 emulator, the ROM image must actually include the editor ROM too.
  530.  
  531. <A NAME="IDX221"></A>
  532. <DT><CODE>ChargenName</CODE>
  533. <DD>
  534. String specifying the name of the character generator ROM (default
  535. <TT>`chargen'</TT>).
  536.  
  537. <A NAME="IDX222"></A>
  538. <DT><CODE>KernalRev</CODE>
  539. <DD>
  540. String specifying the Kernal revision.  This resource can be used to
  541. control what revision of the C64 kernal is being used; it cannot be
  542. changed at runtime.  VICE is able to automatically convert one ROM
  543. revision into another, by manually patching the loaded image.  This way,
  544. it is possible to use any of the ROM revisions without changing the ROM
  545. set.  Valid values are:
  546.  
  547. <DL COMPACT>
  548.  
  549. <DT><CODE>0</CODE>
  550. <DD>
  551. Kernal revision 0;
  552. <DT><CODE>3</CODE>
  553. <DD>
  554. Kernal revision 3;
  555. <DT><CODE>sx</CODE>
  556. <DD>
  557. <DT><CODE>67</CODE>
  558. <DD>
  559. Commodore SX-64 ROM;
  560. <DT><CODE>100</CODE>
  561. <DD>
  562. <DT><CODE>4064</CODE>
  563. <DD>
  564. Commodore 4064 (also known as "PET64" or "Educator 64") ROM.
  565. </DL>
  566.  
  567. </DL>
  568.  
  569.  
  570.  
  571. <H4><A NAME="SEC88" HREF="vice_toc.html#TOC88">7.1.5.2  C64/128 system ROM command-line options</A></H4>
  572.  
  573. <DL COMPACT>
  574.  
  575. <DT><CODE>-kernal NAME</CODE>
  576. <DD>
  577. <A NAME="IDX223"></A>
  578.  
  579. Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
  580.  
  581. <A NAME="IDX224"></A>
  582. <DT><CODE>-basic NAME</CODE>
  583. <DD>
  584. Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
  585.  
  586. <A NAME="IDX225"></A>
  587. <DT><CODE>-chargen NAME</CODE>
  588. <DD>
  589. Specify <TT>`NAME'</TT> as the character generator ROM file
  590. (<CODE>ChargenName</CODE>).
  591.  
  592. <A NAME="IDX226"></A>
  593. <DT><CODE>-kernalrev REVISION</CODE>
  594. <DD>
  595. Specify Kernal revision (<CODE>KernalRev</CODE>).
  596.  
  597. </DL>
  598.  
  599.  
  600.  
  601. <H2><A NAME="SEC89" HREF="vice_toc.html#TOC89">7.2  VIC20-specific commands and settings</A></H2>
  602.  
  603. <P>
  604. This section lists the settings and commands that are VIC20-specific and
  605. thus are not present in the other emulators.
  606.  
  607. </P>
  608.  
  609.  
  610.  
  611. <H3><A NAME="SEC90" HREF="vice_toc.html#TOC90">7.2.1  Using cartridge images</A></H3>
  612.  
  613. <P>
  614. As with the C64 (see section <A HREF="vice_7.html#SEC76">7.1.1  Using cartridge images</A>), it is possible to attach
  615. several types of cartridge images:
  616.  
  617. </P>
  618.  
  619. <UL>
  620. <LI>
  621.  
  622. 4 or 8 Kbyte cartridges located at $2000;
  623. <LI>
  624.  
  625. 4 or 8 Kbyte cartridges located at $4000;
  626. <LI>
  627.  
  628. 4 or 8 Kbyte cartridges located at $6000;
  629. <LI>
  630.  
  631. 4 or 8 Kbyte cartridges located at $A000;
  632. <LI>
  633.  
  634. 4 Kbyte cartridges located at $B000.
  635. </UL>
  636.  
  637. <P>
  638. This can all be done via the "Attach cartridge image..." command in
  639. the left-button menu.  It is also possible to let XVIC "guess" the
  640. type of cartridge using "Smart-attach cartridge image...".
  641.  
  642. </P>
  643. <P>
  644. Notice that several cartridges are actually made up of two pieces (and
  645. two files), that need to be loaded separately at different addresses.
  646. In that case, you have to know the addresses (which are usually
  647. specified in the file name) and use the "attach" command twice.
  648.  
  649. </P>
  650. <P>
  651. A special kind of cartridge file is where the two files mentioned
  652. above are concatenated (with removing the two byte load address of
  653. the second image) into one 16k image. There are only few of those
  654. images, though. Normally the second part is located at $A000. 
  655. Vice can now attach such concatenated files at the start address
  656. $2000, $4000, and $6000. The second half of such an image is
  657. moved to $A000. If you encounter 16k images that have the second
  658. half not at $A000 you can split the image into two halfs 
  659. (i.e. one 8194 byte and one 8192 byte, because the first has the load
  660. address) and attach both files separately.
  661.  
  662. </P>
  663. <P>
  664. One cartridge that is currently only partially supported here is
  665. the VIC1112 IEEE488 interface. You have to load the ROM as a cartridge,
  666. but you also have to enable the IEEE488 hardware by menu.
  667.  
  668. </P>
  669.  
  670.  
  671. <H3><A NAME="SEC91" HREF="vice_toc.html#TOC91">7.2.2  Changing memory configuration</A></H3>
  672.  
  673. <P>
  674. It is possible to change the VIC20 memory configuration in two ways: by
  675. enabling and/or disabling certain individual memory blocks, or by
  676. choosing one among a few typical memory configurations.  The former can
  677. be done by modifying resource values directly or from the right-button
  678. menu; the latter can only be done from the menu.
  679.  
  680. </P>
  681. <P>
  682. There are 5 RAM expansion blocks in the VIC20, numbered 0, 1, 2, 3 and
  683. 5:
  684.  
  685. </P>
  686.  
  687. <UL>
  688. <LI>
  689.  
  690. block 0 (3 Kbytes at $0400-$0FFF);
  691. <LI>
  692.  
  693. block 1 (8 Kbytes at $2000-$3FFF);
  694. <LI>
  695.  
  696. block 2 (8 Kbytes at $4000-$5FFF);
  697. <LI>
  698.  
  699. block 3 (8 Kbytes at $6000-$7FFF);
  700. <LI>
  701.  
  702. block 5 (8 Kbytes at $A000-$BFFF).
  703. </UL>
  704.  
  705. <P>
  706. These blocks are called <EM>expansion blocks</EM> because they are not
  707. present a stock ("unexpanded") machine.  Each of them is associated to
  708. a boolean <CODE>RamBlockX</CODE> resource (where <CODE>X</CODE> is the block number)
  709. that specifies whether the block is enabled or not.
  710.  
  711. </P>
  712. <P>
  713. There are also some common memory configurations you can pick from the
  714. right-button menu:
  715.  
  716. </P>
  717.  
  718. <UL>
  719. <LI>
  720.  
  721. no RAM expansion blocks at all;
  722. <LI>
  723.  
  724. all RAM expansion blocks enabled;
  725. <LI>
  726.  
  727. 3K expansion (only block 0 is enabled);
  728. <LI>
  729.  
  730. 8K expansion (only block 1 is enabled);
  731. <LI>
  732.  
  733. 16K expansion (only blocks 1 and 2 are enabled);
  734. <LI>
  735.  
  736. 24K expansion (only blocks 1, 2 and 3 are enabled).
  737. </UL>
  738.  
  739. <P>
  740. As with the X64 (see section <A HREF="vice_7.html#SEC83">7.1.4  C64 I/O extension settings</A>), it is also
  741. possible to enable a special emulator identification mechanism that uses
  742. certain memory locations to let a running program query information
  743. about the emulator itself; this is enabled by the "Emulator
  744. identification" option.
  745.  
  746. </P>
  747.  
  748.  
  749.  
  750. <H4><A NAME="SEC92" HREF="vice_toc.html#TOC92">7.2.2.1  VIC20 memory configuration resources</A></H4>
  751.  
  752. <DL COMPACT>
  753.  
  754. <DT><CODE>RAMBlock0</CODE>
  755. <DD>
  756. <A NAME="IDX227"></A>
  757.  
  758. <A NAME="IDX228"></A>
  759. <DT><CODE>RAMBlock1</CODE>
  760. <DD>
  761. <A NAME="IDX229"></A>
  762. <DT><CODE>RAMBlock2</CODE>
  763. <DD>
  764. <A NAME="IDX230"></A>
  765. <DT><CODE>RAMBlock3</CODE>
  766. <DD>
  767. <A NAME="IDX231"></A>
  768. <DT><CODE>RAMBlock5</CODE>
  769. <DD>
  770. Booleans specifying whether RAM blocks 0, 1, 2, 3 and 5 must be enabled.
  771.  
  772. <A NAME="IDX232"></A>
  773. <DT><CODE>EmuID</CODE>
  774. <DD>
  775. Boolean specifying whether the emulation identification extension must
  776. be enabled.
  777.  
  778. </DL>
  779.  
  780.  
  781.  
  782. <H4><A NAME="SEC93" HREF="vice_toc.html#TOC93">7.2.2.2  VIC20 memory configuration command-line options</A></H4>
  783.  
  784. <DL COMPACT>
  785.  
  786. <DT><CODE>-memory CONFIG</CODE>
  787. <DD>
  788. <A NAME="IDX233"></A>
  789.  
  790. Specify memory configuration.  It must be a comma-separated list of
  791. options, each of which can be one the following:
  792.  
  793.  
  794. <UL>
  795. <LI>
  796.  
  797. <CODE>none</CODE> (no extension);
  798. <LI>
  799.  
  800. <CODE>all</CODE> (all blocks);
  801. <LI>
  802.  
  803. <CODE>3k</CODE> (3k space in block 0);
  804. <LI>
  805.  
  806. <CODE>8k</CODE> (first 8k extension block);
  807. <LI>
  808.  
  809. <CODE>16k</CODE> (first and second 8k extension blocks);
  810. <LI>
  811.  
  812. <CODE>24k</CODE> (first, second and 3rd extension blocks);
  813. <LI>
  814.  
  815. <CODE>0</CODE>, <CODE>1</CODE>, <CODE>2</CODE>, <CODE>3</CODE>, <CODE>5</CODE> (memory in respective
  816. blocks);
  817. <LI>
  818.  
  819. <CODE>04</CODE>, <CODE>20</CODE>, <CODE>40</CODE>, <CODE>60</CODE>, <CODE>A0</CODE> (memory at
  820. respective address.
  821. </UL>
  822.  
  823. For example,
  824.  
  825.  
  826. <PRE>
  827. xvic -memory none
  828. </PRE>
  829.  
  830. gives an unexpanded VIC20.  While
  831.  
  832.  
  833. <PRE>
  834. xvic -memory 60,a0
  835. </PRE>
  836.  
  837. or
  838.  
  839.  
  840. <PRE>
  841. xvic -memory 3,5
  842. </PRE>
  843.  
  844. enables memory in blocks 3 and 5, which is the usual configuration for
  845. 16k ROM modules.
  846.  
  847. <A NAME="IDX234"></A>
  848. <DT><CODE>-emuid</CODE>
  849. <DD>
  850. <DT><CODE>+emuid</CODE>
  851. <DD>
  852. Enable (<CODE>EmuID=1</CODE>) or disable (<CODE>EmuID=0</CODE>) the emulation
  853. identification extension.
  854.  
  855. </DL>
  856.  
  857.  
  858.  
  859. <H3><A NAME="SEC94" HREF="vice_toc.html#TOC94">7.2.3  VIC20 system ROM settings</A></H3>
  860.  
  861. <P>
  862. These settings can be used to control what system ROMs are loaded in the
  863. VIC20 emulator at startup.  They cannot be changed from the menus.
  864.  
  865. </P>
  866.  
  867.  
  868.  
  869. <H4><A NAME="SEC95" HREF="vice_toc.html#TOC95">7.2.3.1  VIC20 system ROM resources</A></H4>
  870.  
  871. <DL COMPACT>
  872.  
  873. <DT><CODE>KernalName</CODE>
  874. <DD>
  875. <A NAME="IDX235"></A>
  876.  
  877. String specifying the name of the Kernal ROM (default <TT>`kernal'</TT>).
  878.  
  879. <A NAME="IDX236"></A>
  880. <DT><CODE>BasicName</CODE>
  881. <DD>
  882. String specifying the name of the Basic ROM (default <TT>`basic'</TT>).
  883.  
  884. <A NAME="IDX237"></A>
  885. <DT><CODE>ChargenName</CODE>
  886. <DD>
  887. String specifying the name of the character generator ROM (default
  888. <TT>`chargen'</TT>).
  889.  
  890. <A NAME="IDX238"></A>
  891. <A NAME="IDX239"></A>
  892. <A NAME="IDX240"></A>
  893. <A NAME="IDX241"></A>
  894. <A NAME="IDX242"></A>
  895. <DT><CODE>CartridgeFile2000</CODE>
  896. <DD>
  897. <DT><CODE>CartridgeFile4000</CODE>
  898. <DD>
  899. <DT><CODE>CartridgeFile6000</CODE>
  900. <DD>
  901. <DT><CODE>CartridgeFileA000</CODE>
  902. <DD>
  903. <DT><CODE>CartridgeFileB000</CODE>
  904. <DD>
  905. String specifying the name of the respective cartridge ROM images.
  906.  
  907. </DL>
  908.  
  909.  
  910.  
  911. <H4><A NAME="SEC96" HREF="vice_toc.html#TOC96">7.2.3.2  VIC20 system ROM command-line options</A></H4>
  912.  
  913. <DL COMPACT>
  914.  
  915. <DT><CODE>-kernal NAME</CODE>
  916. <DD>
  917. <A NAME="IDX243"></A>
  918.  
  919. Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
  920.  
  921. <A NAME="IDX244"></A>
  922. <DT><CODE>-basic NAME</CODE>
  923. <DD>
  924. Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
  925.  
  926. <A NAME="IDX245"></A>
  927. <DT><CODE>-chargen NAME</CODE>
  928. <DD>
  929. Specify <TT>`NAME'</TT> as the character generator ROM file
  930. (<CODE>ChargenName</CODE>).
  931.  
  932. <A NAME="IDX246"></A>
  933. <A NAME="IDX247"></A>
  934. <A NAME="IDX248"></A>
  935. <A NAME="IDX249"></A>
  936. <A NAME="IDX250"></A>
  937. <DT><CODE>-cart2 NAME</CODE>
  938. <DD>
  939. <DT><CODE>-cart4 NAME</CODE>
  940. <DD>
  941. <DT><CODE>-cart6 NAME</CODE>
  942. <DD>
  943. <DT><CODE>-cartA NAME</CODE>
  944. <DD>
  945. <DT><CODE>-cartB NAME</CODE>
  946. <DD>
  947. Specify <TT>`NAME'</TT> as the cartridge image to attach.
  948. (<CODE>CartridgeFile2000</CODE>,...,<CODE>CartridgeFileB000</CODE>).
  949.  
  950. </DL>
  951.  
  952.  
  953.  
  954. <H2><A NAME="SEC97" HREF="vice_toc.html#TOC97">7.3  PET-specific commands and settings</A></H2>
  955.  
  956. <P>
  957. This section lists the settings and commands that are PET-specific and
  958. thus are not present in the other emulators.
  959.  
  960. </P>
  961.  
  962.  
  963.  
  964. <H3><A NAME="SEC98" HREF="vice_toc.html#TOC98">7.3.1  Changing PET model settings</A></H3>
  965.  
  966. <P>
  967. With <CODE>xpet</CODE>, it is possible to change at runtime the
  968. characteristics of the emulated PET so that it matches (or not) the ones
  969. of a certain PET model, and it is also possible to select from a common
  970. set of PET models so that all the features are selected accordingly.
  971.  
  972. </P>
  973. <P>
  974. The former is done by changing the following resources (via resource
  975. file, command line options or right-menu items):
  976.  
  977. </P>
  978. <DL COMPACT>
  979.  
  980. <DT><CODE>RamSize</CODE>
  981. <DD>
  982. <A NAME="IDX251"></A>
  983.  
  984. Size of memory in kByte. 96k denotes a 8096, 128k a 8296.
  985.  
  986. <A NAME="IDX252"></A>
  987. <DT><CODE>IOSize</CODE>
  988. <DD>
  989. Size of I/O area in Byte.  Either 2048 or 256 for 8296.
  990.  
  991. <A NAME="IDX253"></A>
  992. <DT><CODE>Crtc</CODE>
  993. <DD>
  994. Enables CRTC 6545 emulation (all models from 40xx and above)
  995.  
  996. <A NAME="IDX254"></A>
  997. <DT><CODE>VideoSize</CODE>
  998. <DD>
  999. The number of columns on the screen (40 or 80).  A 0 auto-detects this
  1000. from the ROM.
  1001.  
  1002. <A NAME="IDX255"></A>
  1003. <DT><CODE>Ram9</CODE>
  1004. <DD>
  1005. The 8296 can map RAM into the address range $9***
  1006.  
  1007. <A NAME="IDX256"></A>
  1008. <DT><CODE>RamA</CODE>
  1009. <DD>
  1010. The 8296 can map RAM into the address range $A***
  1011.  
  1012. <A NAME="IDX257"></A>
  1013. <DT><CODE>SuperPET</CODE>
  1014. <DD>
  1015. This resource enables the SuperPET (MicroMainFrame 9000) I/O
  1016. and disables the 8x96 mappings.
  1017.  
  1018. <A NAME="IDX258"></A>
  1019. <DT><CODE>Basic1</CODE>
  1020. <DD>
  1021. If (by checksum) a version 1 kernal is detected, then the 
  1022. kernal ROM is patched to make the IEEE488 interface work.
  1023.  
  1024. <A NAME="IDX259"></A>
  1025. <DT><CODE>Basic1Chars</CODE>
  1026. <DD>
  1027. Exchanges some character in the character ROM that have changed
  1028. between the first PET 2001 and all newer versions.
  1029.  
  1030. <A NAME="IDX260"></A>
  1031. <DT><CODE>EoiBlank</CODE>
  1032. <DD>
  1033. This resource enables the "blank screen on EOI" feature of the 
  1034. oldest PET 2001.
  1035.  
  1036. <A NAME="IDX261"></A>
  1037. <DT><CODE>EmuID</CODE>
  1038. <DD>
  1039. Enable emulator ID (at <CODE>$e8a0-$e8ff</CODE>, for use see C64).
  1040.  
  1041. <A NAME="IDX262"></A>
  1042. <DT><CODE>DiagPin</CODE>
  1043. <DD>
  1044. Set the diagnositc pin on the PET userport (see below).
  1045.  
  1046. <A NAME="IDX263"></A>
  1047. <DT><CODE>ChargenName</CODE>
  1048. <DD>
  1049. Specify <TT>`NAME'</TT> as the character generator ROM file
  1050.  
  1051. <A NAME="IDX264"></A>
  1052. <DT><CODE>KernalName</CODE>
  1053. <DD>
  1054. Specify <TT>`NAME'</TT> as the kernal ROM file.  This file contains the
  1055. complete BASIC, EDITOR and KERNAL ROMs and is either 16k (BASIC 1 and 2)
  1056. or 20k (BASIC 4) in size.
  1057.  
  1058. <A NAME="IDX265"></A>
  1059. <DT><CODE>EditorName</CODE>
  1060. <DD>
  1061. Specify <TT>`NAME'</TT> as the editor ROM file.  This file contains
  1062. an overlay for the editor ROM at $E000-$E7FF if necessary.
  1063.  
  1064. <A NAME="IDX266"></A>
  1065. <DT><CODE>RomModule9Name</CODE>
  1066. <DD>
  1067. Specify <TT>`NAME'</TT> as the $9*** Expansion ROM file.  This file contains
  1068. an expansion ROM image of 4k.
  1069.  
  1070. <A NAME="IDX267"></A>
  1071. <DT><CODE>RomModuleAName</CODE>
  1072. <DD>
  1073. Specify <TT>`NAME'</TT> as the $A*** Expansion ROM file.  This file contains
  1074. an expansion ROM image of 4k.
  1075.  
  1076. <A NAME="IDX268"></A>
  1077. <DT><CODE>RomModuleBName</CODE>
  1078. <DD>
  1079. Specify <TT>`NAME'</TT> as the $B*** Expansion ROM file.  This file contains
  1080. an expansion ROM image of 4k.
  1081. This file overlays the lowest 4k of a BASIC 4 ROM.
  1082.  
  1083. </DL>
  1084.  
  1085. <P>
  1086. Choosing a common PET model is done from the right-button menu instead,
  1087. by choosing an item from the "Model defaults" submenu.  Available
  1088. models are:
  1089.  
  1090. </P>
  1091.  
  1092. <UL>
  1093. <LI>
  1094.  
  1095. PET 2001-8N
  1096. <LI>
  1097.  
  1098. PET 3008
  1099. <LI>
  1100.  
  1101. PET 3016
  1102. <LI>
  1103.  
  1104. PET 3032
  1105. <LI>
  1106.  
  1107. PET 3032B
  1108. <LI>
  1109.  
  1110. PET 4016
  1111. <LI>
  1112.  
  1113. PET 4032
  1114. <LI>
  1115.  
  1116. PET 4032B
  1117. <LI>
  1118.  
  1119. PET 8032
  1120. <LI>
  1121.  
  1122. PET 8096
  1123. <LI>
  1124.  
  1125. PET 8296
  1126. <LI>
  1127.  
  1128. SuperPET
  1129. </UL>
  1130.  
  1131. <P>
  1132. Notice that this will <STRONG>reset the emulated machine</STRONG>.
  1133.  
  1134. </P>
  1135. <P>
  1136. It is also possible to select the PET model at startup, with the
  1137. <CODE>-model</CODE> command-line option: for example, <SAMP>`xpet -model 3032'</SAMP>
  1138. will emulate a PET 3032 while <SAMP>`xpet -model 8296'</SAMP> will emulate a PET
  1139. 8296.
  1140.  
  1141. </P>
  1142.  
  1143.  
  1144.  
  1145. <H3><A NAME="SEC99" HREF="vice_toc.html#TOC99">7.3.2  The PET diagnostic pin</A></H3>
  1146.  
  1147. <P>
  1148. It is possible to enable or disable emulation of the PET diagnostic pin
  1149. via the <CODE>DiagPin</CODE> resource, or the "PET userport diagnostic pin"
  1150. item in the right-button menu.
  1151.  
  1152. </P>
  1153. <P>
  1154. When the diagnostic pin is set, the Kernal does not try to initialize
  1155. the BASIC, but directly jumps into the builtin machine monitor.
  1156.  
  1157. </P>
  1158.  
  1159.  
  1160. <H3><A NAME="SEC100" HREF="vice_toc.html#TOC100">7.3.3  PET command line options</A></H3>
  1161.  
  1162. <P>
  1163. These are the commandline options specific for the CBM-II models.
  1164.  
  1165. </P>
  1166. <DL COMPACT>
  1167.  
  1168. <DT><CODE>-model MODEL</CODE>
  1169. <DD>
  1170. <A NAME="IDX269"></A>
  1171.  
  1172. Specify the PET model you want to emulate.
  1173.  
  1174. <A NAME="IDX270"></A>
  1175. <DT><CODE>-kernal NAME</CODE>
  1176. <DD>
  1177. Specify <TT>`NAME'</TT> as the Kernal/BASIC ROM file (<CODE>KernalName</CODE>).
  1178.  
  1179. <A NAME="IDX271"></A>
  1180. <DT><CODE>-editor NAME</CODE>
  1181. <DD>
  1182. Specify <TT>`NAME'</TT> as the editor ROM file (<CODE>EditorName</CODE>).
  1183.  
  1184. <A NAME="IDX272"></A>
  1185. <DT><CODE>-chargen NAME</CODE>
  1186. <DD>
  1187. Specify <TT>`NAME'</TT> as the character generator ROM file
  1188. (<CODE>ChargenName</CODE>).
  1189.  
  1190. <A NAME="IDX273"></A>
  1191. <A NAME="IDX274"></A>
  1192. <A NAME="IDX275"></A>
  1193. <DT><CODE>-rom9 NAME, -romA NAME, -romB NAME</CODE>
  1194. <DD>
  1195. Specify <TT>`NAME'</TT> as the ROM image file for the respective 
  1196. cartridge areas (<CODE>RomModule9Name</CODE>, <CODE>RomModuleAName</CODE>, 
  1197. <CODE>RomModuleBName</CODE>).
  1198.  
  1199. <A NAME="IDX276"></A>
  1200. <A NAME="IDX277"></A>
  1201. <DT><CODE>-petramA, -petramB</CODE>
  1202. <DD>
  1203. Switch on RAM mapping on addresses 
  1204. $9000-$9fff, $a000-$afff
  1205. (<CODE>Ram9</CODE>, <CODE>RamA</CODE>).
  1206.  
  1207. <A NAME="IDX278"></A>
  1208. <A NAME="IDX279"></A>
  1209. <DT><CODE>-superpet, +superpet</CODE>
  1210. <DD>
  1211. Enable/Disable SuperPET I/O emulation (<CODE>SuperPET</CODE>).
  1212.  
  1213. <A NAME="IDX280"></A>
  1214. <A NAME="IDX281"></A>
  1215. <DT><CODE>-basic1, +basic1</CODE>
  1216. <DD>
  1217. Enable/Disable patching the IEEE488 section of the PET2001 ROM when detected
  1218. (<CODE>Basic1</CODE>).
  1219.  
  1220. <A NAME="IDX282"></A>
  1221. <A NAME="IDX283"></A>
  1222. <DT><CODE>-basic1char, +basic1char</CODE>
  1223. <DD>
  1224. Enable/Disable PET 2001 character generator
  1225. (<CODE>Basic1Chars</CODE>).
  1226.  
  1227. <A NAME="IDX284"></A>
  1228. <A NAME="IDX285"></A>
  1229. <DT><CODE>-eoiblank, +eoiblank</CODE>
  1230. <DD>
  1231. Enable/Disable EOI blanking the screen
  1232. (<CODE>EoiBlank</CODE>).
  1233.  
  1234. <A NAME="IDX286"></A>
  1235. <DT><CODE>-emuid</CODE>
  1236. <DD>
  1237. <DT><CODE>+emuid</CODE>
  1238. <DD>
  1239. Enable (<CODE>EmuID=1</CODE>) or disable (<CODE>EmuID=0</CODE>) the emulation
  1240. identification extension (at <CODE>$e8a0-$e8ff</CODE>).
  1241.  
  1242. <A NAME="IDX287"></A>
  1243. <DT><CODE>-diagpin</CODE>
  1244. <DD>
  1245. <DT><CODE>+diagpin</CODE>
  1246. <DD>
  1247. Enable (<CODE>DiagPin=1</CODE>) or disable (<CODE>DiagPin=0</CODE>) the 
  1248. diagnostic pin at the PET userport.
  1249.  
  1250. </DL>
  1251.  
  1252.  
  1253.  
  1254. <H3><A NAME="SEC101" HREF="vice_toc.html#TOC101">7.3.4  Changing screen colors</A></H3>
  1255.  
  1256. <P>
  1257. It is also possible to choose what color set is used for the emulation
  1258. window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC26">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
  1259. following values:
  1260.  
  1261. </P>
  1262.  
  1263. <UL>
  1264. <LI>
  1265.  
  1266. <CODE>green.vpl</CODE> (default, "green)"), the good old green-on-black
  1267. feeling;
  1268. <LI>
  1269.  
  1270. <CODE>amber.vpl</CODE> ("amber"), an amber phosphor lookalike;
  1271. <LI>
  1272.  
  1273. <CODE>white.vpl</CODE> ("white"), simple white-on-black palette.
  1274. </UL>
  1275.  
  1276.  
  1277.  
  1278. <H2><A NAME="SEC102" HREF="vice_toc.html#TOC102">7.4  CBM-II-specific commands and settings</A></H2>
  1279.  
  1280. <P>
  1281. This section lists the settings and commands that are CBM-II-specific and
  1282. thus are not present in the other emulators.
  1283.  
  1284. </P>
  1285.  
  1286.  
  1287.  
  1288. <H3><A NAME="SEC103" HREF="vice_toc.html#TOC103">7.4.1  Changing CBM-II model</A></H3>
  1289.  
  1290. <P>
  1291. With <CODE>xcbm2</CODE>, it is possible to change at runtime the
  1292. characteristics of the emulated CBM so that it matches (or not) the ones
  1293. of a certain CBM model, and it is also possible to select from a common
  1294. set of CBM models so that all the features are selected accordingly.
  1295.  
  1296. </P>
  1297. <P>
  1298. The former is done by changing the following resources (via resource
  1299. file, command line options or right-menu items):
  1300.  
  1301. </P>
  1302. <DL COMPACT>
  1303.  
  1304. <DT><CODE>UseVicII</CODE>
  1305. <DD>
  1306. <A NAME="IDX288"></A>
  1307.  
  1308. Whether to use VIC-II for video output (value 1) or the CRTC for the
  1309. other machines (value 0)
  1310.  
  1311. <A NAME="IDX289"></A>
  1312. <DT><CODE>RamSize</CODE>
  1313. <DD>
  1314. Size of memory in kByte.  Possible values are 128, 256, 512 and 1024
  1315.  
  1316. <A NAME="IDX290"></A>
  1317. <A NAME="IDX291"></A>
  1318. <A NAME="IDX292"></A>
  1319. <A NAME="IDX293"></A>
  1320. <A NAME="IDX294"></A>
  1321. <A NAME="IDX295"></A>
  1322. <DT><CODE>Ram08, Ram1, Ram2, Ram4, Ram6, RamC</CODE>
  1323. <DD>
  1324. Expanded CBM-II models could map RAM to the expansion ROM areas
  1325. at $0800-$0fff, $1000-$1fff, $2000-$3FFF, $4000-$5FFF, $6000-$7FFF
  1326. and $c000-$cfff respectively.
  1327.  
  1328. <A NAME="IDX296"></A>
  1329. <A NAME="IDX297"></A>
  1330. <A NAME="IDX298"></A>
  1331. <DT><CODE>Cart2Name, Cart4Name, Cart6Name</CODE>
  1332. <DD>
  1333. Specify <TT>`NAME'</TT> as the $2000-$3FFF, $4000-$5FFF or $6000-$6FFF
  1334. Expansion ROM file.  This file contains an 8k ROM dump.
  1335.  
  1336. <A NAME="IDX299"></A>
  1337. <DT><CODE>ModelLine</CODE>
  1338. <DD>
  1339. The CBM-II business models have two hardcoded lines at one of the I/O ports.
  1340. From those lines the kernal determines how it should init the 
  1341. CRTC video chip for either 50Hz (Europe) or 60Hz (North America),
  1342. and either for 8 (C6x0) or 14 (C7x0) scanlines per character.
  1343. 0 = CBM 7x0 (50Hz), 1 = 60Hz C6x0, 2 = 50Hz C6x0).
  1344.  
  1345. </DL>
  1346.  
  1347. <P>
  1348. Choosing a common CBM-II model is done from the right-button menu instead,
  1349. by choosing an item from the "Model defaults" submenu.  Available
  1350. models are:
  1351.  
  1352. </P>
  1353.  
  1354. <UL>
  1355. <LI>
  1356.  
  1357. C510 (128k RAM)
  1358. <LI>
  1359.  
  1360. C610 (128k RAM)
  1361. <LI>
  1362.  
  1363. C620 (256k RAM)
  1364. <LI>
  1365.  
  1366. C620+ (1024k RAM, expanded)
  1367. <LI>
  1368.  
  1369. C710 (128k RAM)
  1370. <LI>
  1371.  
  1372. C720 (256k RAM)
  1373. <LI>
  1374.  
  1375. C720+ (1024k RAM, expanded)
  1376. </UL>
  1377.  
  1378. <P>
  1379. Notice that this will <STRONG>reset the emulated machine</STRONG>.
  1380.  
  1381. </P>
  1382. <P>
  1383. <B>Warning:</B> At this time switching between 510 and other machines during
  1384. runtime is not supported and will not work.
  1385.  
  1386. </P>
  1387. <P>
  1388. It is also possible to select the CBM model at startup, with the
  1389. <CODE>-model</CODE> command-line option: for example, <SAMP>`xcbm2 -model 610'</SAMP>
  1390. will emulate a CBM 610 while <SAMP>`xcbm2 -model 620'</SAMP> will emulate a CBM
  1391. 620. Notably this is the only way to start a C510 emulation, with
  1392. <CODE>-model 510</CODE>.
  1393.  
  1394. </P>
  1395.  
  1396.  
  1397. <H3><A NAME="SEC104" HREF="vice_toc.html#TOC104">7.4.2  CBM-II command line options</A></H3>
  1398.  
  1399. <P>
  1400. These are the commandline options specific for the CBM-II models.
  1401.  
  1402. </P>
  1403. <DL COMPACT>
  1404.  
  1405. <DT><CODE>-usevicii</CODE>
  1406. <DD>
  1407. <A NAME="IDX300"></A>
  1408.  
  1409. <DT><CODE>+usevicii</CODE>
  1410. <DD>
  1411. Specify whether to use (-usevicii) or not to use (+usevicii) the VIC-II 
  1412. emulation.
  1413.  
  1414. <A NAME="IDX301"></A>
  1415. <DT><CODE>-kernal NAME</CODE>
  1416. <DD>
  1417. Specify <TT>`NAME'</TT> as the Kernal ROM file (<CODE>KernalName</CODE>).
  1418.  
  1419. <A NAME="IDX302"></A>
  1420. <DT><CODE>-basic NAME</CODE>
  1421. <DD>
  1422. Specify <TT>`NAME'</TT> as the Basic ROM file (<CODE>BasicName</CODE>).
  1423.  
  1424. <A NAME="IDX303"></A>
  1425. <DT><CODE>-chargen NAME</CODE>
  1426. <DD>
  1427. Specify <TT>`NAME'</TT> as the character generator ROM file
  1428. (<CODE>ChargenName</CODE>).
  1429.  
  1430. <A NAME="IDX304"></A>
  1431. <A NAME="IDX305"></A>
  1432. <A NAME="IDX306"></A>
  1433. <DT><CODE>-cart2 NAME, -cart4 NAME, -cart6 NAME</CODE>
  1434. <DD>
  1435. Specify <TT>`NAME'</TT> as the ROM image file for the respective 
  1436. cartridge areas (<CODE>Cart2Name</CODE>, <CODE>Cart4Name</CODE>, <CODE>Cart6Name</CODE>).
  1437.  
  1438. <A NAME="IDX307"></A>
  1439. <A NAME="IDX308"></A>
  1440. <A NAME="IDX309"></A>
  1441. <A NAME="IDX310"></A>
  1442. <A NAME="IDX311"></A>
  1443. <A NAME="IDX312"></A>
  1444. <DT><CODE>-ram08, -ram1, -ram2, -ram4, -ram6, -ramC</CODE>
  1445. <DD>
  1446. Switch on RAM mapping in bank 15 on addresses 
  1447. $0800-$0fff, $1000-$1fff, $2000-$3fff, $4000-$5fff, $6000-$7fff resp
  1448. (<CODE>Ram08</CODE>, <CODE>Ram1</CODE>, <CODE>Ram2</CODE>, <CODE>Ram4</CODE>, <CODE>Ram6</CODE>,
  1449. <CODE>RamC</CODE>).
  1450.  
  1451. <A NAME="IDX313"></A>
  1452. <DT><CODE>-modelline</CODE>
  1453. <DD>
  1454. Define the hardcoded model switch in the CBM-II models.
  1455.  
  1456. </DL>
  1457.  
  1458.  
  1459.  
  1460. <H3><A NAME="SEC105" HREF="vice_toc.html#TOC105">7.4.3  Changing screen colors</A></H3>
  1461.  
  1462. <P>
  1463. It is also possible to choose what color set is used for the emulation
  1464. window.  This is done by specifying a palette file name (see section <A HREF="vice_4.html#SEC26">4.3  Palette files</A>) in the <CODE>PaletteName</CODE> resource.  The menu provides the
  1465. following values:
  1466.  
  1467. </P>
  1468.  
  1469. <UL>
  1470. <LI>
  1471.  
  1472. <CODE>green.vpl</CODE> (default, "green"), the good old green-on-black
  1473. feeling;
  1474. <LI>
  1475.  
  1476. <CODE>amber.vpl</CODE> ("amber"), an amber phosphor lookalike;
  1477. <LI>
  1478.  
  1479. <CODE>white.vpl</CODE> ("white"), simple white-on-black palette.
  1480. </UL>
  1481.  
  1482. <P><HR><P>
  1483. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_6.html">previous</A>, <A HREF="vice_8.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  1484. </BODY>
  1485. </HTML>
  1486.